home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_1
/
killrq31.zip
/
KILLRQ.DOC
< prev
next >
Wrap
Text File
|
1992-08-13
|
6KB
|
129 lines
KillRQ v 3.1
INTRODUCTION: KillRQ is an automated message base deletion
system for Hudson-style message bases (QuickBBS, Remote Access,
SuperBBS, etc). KillRQ is provided free of charge for use in non-
commericial environments. Use in commercial or governmental
environments is not authorized. No warranty is expressed or implied.
If you break KillRQ or if KillRQ breaks you, it is your problem. Free
software is worth exactly what you pay for it. :+)
COMMAND LINE: KillRQ is executed from the command line or batch
file as follows:
KILLRQ.EXE <config filename>
The config file name is optional. If no config file name is
present, KillRQ will default to file KILLRQ.CFG in the current
directory. If a filename is provided on the command line, KillRQ will
append a .CFG extension onto it and attempt to use that as a filename
for the config file. No extension should be placed on the command line --
KillRQ will append a .CFG extension anyway and an extension already there
will cause KillRQ to be unable to find the config file.
If the config file is not found, KillRQ will abort.
CONFIG FILE: The config file is a text (ASCII) file created by
the sysop which tells KillRQ what it is supposed to do. Config
commands are listed one to a line, each line being terminated by a
hard carraige return (ASCII #13). Text after a semi-colon ";" character
will be ignored. A sample config file is included with the distribution
archive. Each line is in the following format:
<command word> <board #> <identification text>
ALL may be used in place of a board number to delete from all
board numbers. In the identification text field, an underscore (_)
should be used to identify a space between words. All comparisons are
done in a case-insensitive manner -- "MEAN GUY" is exactly the same as
"mean guy" in the eyes of the program.
Seven command words are enabled in this version of KillRQ.
1) RESTRIP: RESTRIP need not have either a board number or
identification text parameter. RESTRIP will cause KillRQ to strip RE:
and Re: from the subject lines in the message base. As KillRQ is
going to scan all messages in the message base at one time or another
anyway, this capability is a natural "throw-in" which may be useful on
many systems to normalize subject lines.
2) KILLFROM or KF: The KILLFROM (abbreviation KF) command word
instructs KillRQ to delete messages which are FROM the individual
specified in the identification text and which are on the board number
specified (or all boards if the ALL word is used).
3) KILLTO or KT: The KILLTO (abbreviation KT) command word
instructs KillRQ to delete messages which are TO the individual
specified in the identification text and which are on the board number
specified (or all boards if the ALL word is used).
4) KILLSUBJ or KS: The KILLSUBJ (abbreviation KS) command word
instructs KillRQ to delete messages in which the identification text
is a part of the subject and which are on the board number specified
(or all boards if the ALL word is used).
5) KILLTEXT or KX: The KILLTEXT (abbreviation KX) command word
instructs KillRQ to delete messages in which the identified text appears
within the same sentence or phrase and which are on the board number
specified (or all boards if the ALL word is used). ( *NOTE* This
operation can be a VERY time-consuming one.)
6) FULLSCAN: FULLSCAN will cause KillRQ to begin scanning from
the start of the message base header file, ignoring the last-read marker.
7) SHAREMODE: SHAREMODE will enable KillRQ to operate while
other share-aware software is accessing the message base. This is very
necessary for multi-line operations or places where mail may process
congruant to other-program access of the message base (BBS in local mode or
sysop offline reader).
RUNTIME METHOD: When run, KillRQ will first check for its config
file, terminating if the config file is not found. It will then
attempt to process the config file. If no valid commands are found in
the config file, KillRQ will terminate.
After processing the config file, KillRQ will attempt to open the
message base files. If the message base files are not found in the
current directory or if there is a problem detected with the message
base files (such as size errors), then KillRQ will terminate.
After opening the message base files, KillRQ will open a file
with the same name as the config file although with the extension
.CTL. This file is where KillRQ "remembers" the last message number
scanned. If this file is not found or the number within is higher
than the highest number in the message base (such as following a
message base pack), KillRQ will start with the first message in the
message base.
Starting at the number thus determined, KillRQ will scan to the
end of the message base, automatically deleting messages in accordance
with the parameters defined in the config file. Each deletion will be
reported on the screen. Speed tests indicate that KillRQ is quite
fast, being able to scan an entire 4000 messages in about 15 seconds
on a 386SX/16 machine and a 18ms hard drive.
After it is done scanning, KillRQ will store the number of the
last message scanned back into the .CTL file and end.
BUGS, SUGGESTIONS, AND FUTURE PLANS: Bug and problem reports may
be sent to Jason Steck at 1:104/424@FidoNet and 200:5000/400@MetroNet.
Flames and treatsies on the (de)merits of censorship should be sent to
the nearest available bit bucket--I just makes 'em, I don't forces
anyone to uses 'em. However, compliments and input for improvements
are always welcome.
Jason Steck
1:104/424@FidoNet
200:5000/400@MetroNet
8:7703/10@FMLYNet